Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILE_CHG / RTRIM54.ZIP / RTRIM.DOC < prev next >

Wrap

Text File | 1993-04-08 | 27.6 KB | 583 lines

RTRIM - VERSION 5.4 Author - Bob Keber TypeRight 336 Swain Blvd. Lake Worth, FL 33463 (407) 969-3643 Voice Fax (407) 964-0785 DISCLAIMER Use This Software At Your Own Risk The author of this software makes or offers no warranty, either expressed or implied, regarding any of the software programs included with this package. There is no warranty for this software's usefulness, or for it's fitness for any particular purpose. The author will not be liable for any damages arising from the use of (or from the inability to use) this software. The author will not be liable for lost profits, lost savings, lost income, lost time, lost or damaged files, claims by other parties, or for other incidental or consequential damages arising from the use of (or from the inability to use) this software. Use (or misuse) of this software is entirely at the user's own risk. NO CHARGE - FREE USE NO CHARGE: This program has been released for the free use of anyone who finds it useful. However, this does NOT allow or give permission to any other person or organization to "Sell" copies of this program to others. If you wish to obtain the latest, debugged and improved version directly from the author, then print out and mail in the Registration Form contained in the enclosed file called "Register.Doc". There is a small fee for this service, which will help cover our time, materials and shipping costs. GETTING STARTED FOR "QUICK" RTRIM OPERATION: Enter one of the following commands from any DOS or MS/DOS Screen Prompt...... RTRIM (Runs RTRIM with full screen menus & help) RTRIM FileName.Ext (Will Strip BLANKS from RIGHT END of text lines) RTRIM FileName.Ext/H (Trims RIGHT-BLANKS & Converts HI-BIT Characters) RTRIM FileName.Ext/L (Removes Excessive "Blank" Lines from a file) RTRIM FileName.Ext/J (Will "Un-Justify" a file - Removes 2-3 spacebars) RTRIM FileName.Ext/E (Trims RIGHT-BLANKS & Removes "Escape Codes" such as FORM FEEDS & END OF PAGE) RTRIM FileName.Ext/H/E/L/J (Does all of the above) "FileName.Ext" represents the name of your TEXT file that you wish to have RTRIM.EXE work on. For instance, if you wanted to use "RTRIM.DOC" as your input file, you would enter "RTRIM RTRIM.DOC". RTRIM is designed to be placed somewhere in your "PATH" (Example: in your "ROOT-DIRECTORY") so that it can be accessed from anywhere in your system by simply typing "RTRIM". As a result, the program DOES NOT support "Path File Names" (eg: A:\TEST\MY.DOC), and will ONLY work upon files in your DEFAULT DRIVE & DIRECTORY. If you use a "Path" in your file name, the program will generate the error message "File Not Found". The same "may" be true if you run RTRIM from inside of some kind of "WINDOW" or "MENU" program which may reach across different drives and directories to work it's magic. You may use some of the DOS "WildCard" names to select more than one file in the same directory. Entries such as "*.DOC" or "????????.TXT" will "trim" ALL the files who's names end with "DOC" or "TXT" in your default Drive & Directory. The "OUTPUT" file's name will be the same as the "INPUT" file, except for the last character in the name, which will be changed to "@". In other words, "TEST.DOC" would have an "R-Trimmed" output file called "TEST.DO@". If an output file already exists with the same "@" name, the program will warn you, and offer the options of "Over-write" or "Quit". RTRIM will NOT check for "Free Disk Space" before it starts to create all the output files. It's up to YOU to make sure that there is about the same amount of free space available that your DOC files use. The output file(s) will contain a copy of your original file(s), but with all of the changes you elected to perform. Your original file(s) will be left unchanged. Always check over your Output File(s) VERY carefully BEFORE you replace your Original with it. Make sure that "Charts", "Boxes", "Graphs", and so on, are as they should be, and that any "Page Offset" insertion or removal has not effected the text in a negative manner. If your Input File has ANY GRAPHIC CHARACTERS which you wish to have left alone (Boxes, Pictures, Drawings or Source Code containing any Command Line Graphics), DO NOT tell RTRIM to convert HIGH-BITS. RTRIM will happily convert ANY graphic character it finds, because Graphics are HIGH-BIT characters too. This would leave you with Boxes shaped with M's, D's, and a host of other alphabet characters. FOR THE OTHER RTRIM OPTIONS: Enter the following command from any DOS or MS/DOS Screen Prompt.... RTRIM <...and hit Enter> RTRIM.EXE will then load and proceed to guide you through all of the various options with "on-screen" instructions and questions. WHAT IS RTRIM.EXE ? It's a simple little utility for "Adjusting" and "Changing" different kinds of "TEXT" files to suit YOUR OWN needs. RTRIM will "Trim" all of the Spacebars, Nulls, and Blank Spaces that may be invisibly attached to the RIGHT end of each line of text, or which may be invisibly hiding on many of the "Blank" lines within your text (also in any ASCII Source Code). This feature will produce a copy of the original file which (in many cases) is much smaller than the the original file. And yet, it does this without moving the original text's positions in the file. There are NO apparent, VISIBLE differences between the two files except for the difference in sizes. ADDITIONAL "OPTIONAL" FEATURES OPTION #1 - INSTALL PAGE OFFSET - Has the ability to create up to a nine space "Left Margin" or "Page Offset" in the new output file. This allows you to punch holes for the use of binders and report covers without covering up (or punching out) any of the text. OPTION #2 - REMOVE PAGE OFFSET - Has the ability to "Remove" a "Page Offset" from any ASCII Text file. But be cautious, as this routine will ask you "How many Spaces" it should remove from the left side (beginning) of each line of text. If you tell it to remove too many spaces (more than any existing offset), it will quickly remove the beginning characters from each line of text too (in the output file only - originals are never changed at all). OPTION #3 - REMOVE EXCESSIVE BLANK LINES - Has the ability to "Remove" excessive "Blank Lines" from any ASCII Text file. I'm sure that many of us have had the misfortune to innocently begin printing someone's "DOC" file for some program, only to sit and impatiently watch as our printer spits out page after page with little or no text printed on them (eg: "JOE'S PROGRAM" [65 linespaces]..., "VERSION 1" [65 linespaces]..., "A SHAREWARE PROGRAM" [65 linespaces]..., etc.). I swear, some of these authors must own stock in either a Paper Mill or a Garbage Dump. This option eliminates this problem by removing all successive "Blank Lines" when there are three (3) or more in a row. It will allow a maximum of two (2) blank lines together, and then start chopping them out of the text, thereby shortening the file (and the paper required to print it out). If the file contains "PAGE #s", then this option will make them useless. The same is true for page "Headers" and "Footers". But, they can usually be easily removed with most Word Processor's "Find & Replace" features. OPTION #4 - CONVERT HI-BIT WORDSTAR FILES - A feature that will auto- matically reset the "High Bits" on any character that has the "High Bit" set. The above statement may sound "very scary, technical and complicated" to a novice operator, so let me make it simpler by explaining what this routine is most often used for. If you use a Word Processing program (like Wordstar for example), you may find that the text files look something like an "Arab's Alphabet" if you try to read (or print) those files WITHOUT using the Word Processor which created the files in the first place. This kind of problem is especially tough if the file you are trying to read or print originally came from someone else, and YOU DON'T HAVE their brand of Word Processor (which happens on many downloaded files). Those kind of TEXT files will appear a bit scrambled because the "High Bits" are set on the majority of the characters within the file. Why? Who Knows? But we assume that the folks who wrote the Word Processing program (hopefully) had good reasons for doing things like this. All that RTRIM.EXE does is "Reset" the "Bits" back to normal again. It will NOT mess-around with any character who's bit is NOT set to high, so it's safe to run any ASCII Text (NO GRAPHICS) file through this routine. When RTRIM.EXE is done the copy of those files will then look (and print) much the way the Author originally intended them to. OPTION #5: "UN-JUSTIFY" A TEXT FILE - This option will automatically remove all those "double" and "triple" spacebars that many word processors insert into lines of text to make each and every line the exact same length, and have every line end on the exact same column. Originally (when printed from inside of the word processor which created them - with a printer capable of printing variable sized spacebars), those extra spacebars are divided evenly between all the other "normal" spacebars, each of which becomes slightly and equally larger to "justify" the line without all those obvious extra spaces. However, when the same file is converted to a "plain vanilla" ASCII Text file, those extra spaces become "locked" into the text as if they had been put there on purpose. At that point, unless you want to go to an awful lot of work eliminating them one by one by hand, you're stuck with them. But not anymore. "RTRIM" will now "Un-Justify" any text file (eliminate all those extra spacebars), and do it in a pretty intelligent manner at the same time. It won't remove the leading spacebars from ANY line of text. This means that "1st Line Paragraph Indenting" is NOT eliminated. Page offsets and Left Margins are NOT eliminated. "Centered" lines of text will stay "Centered". Beyond that, if there is a double spacebar after a Period, Exclamation or Question Mark ( ! ? . ), it will be left unchanged. About the only places where "RTRIM" will change the text in an "unfavorable" manner is in those places where the text has been purposely separated by only TWO or THREE spacebars..., Quantity Description Part Number Price ___________________________________________________ 1 GOLDFARKLE 1078988 $25.65 ...... would wind up as...., Quantity Description Part Number Price _________________________________________________________ 1 GOLDFARKLE 1078988 $25.65 THE RULE: (By Executive Order!) Any place in the text where RTRIM finds 2 or 3 spacebars in a row, it will trim them down to only ONE space! EXCEPTIONS TO THE RULE: (oops...) When TWO spacebars are located after certain punctuation marks (Period, Question & Exclamation) they will be left alone. When TWO or THREE spacebars are located at the "beginning" of a line of text (like a margin would be), they will also be left alone. When any Text is separated by FOUR (4) or more spacebars, they will also be left alone. (So much for "Iron Clad" rules...) OPTION #6 - REMOVAL OF ESCAPE CODES FROM TEXT What's an Escape Code? While it may sound like something a criminal would use in a "getaway", it's really nothing all that exciting. Escape Codes are simply special codes that are embedded into many text files to tell the printer what to do (Form Feed, New Page, Change Type Style, Change Pitch, Bold On, Bold Off, and so on). IN CLOSING I've done my best to make "RTRIM" behave itself and do this job without causing problems for anyone. But because of the unlimited kinds and types of files that will be run through RTRIM, it's simply not possible (in this day and age) to make it "adjust itself" and perform perfectly to every conceivable situation (which constantly changes, line by line). But bear in mind that all these changes are ONLY done to the OUTPUT file, and NEVER to the ORIGINAL file. As a result, if YOU use a little caution BEFORE erasing your original files, "RTRIM" should never cause you any problems. While you sometimes "might" have to make some manual corrections or adjustments to the output files to make them perfect, it's a good bet that "This" small amount of manual work will be a LOT LESS effort than trying to do the whole job that RTRIM did, by hand. We put together this little utility for our own use, and then found that we used it a lot. So much, that we decided to donate it's use to anyone else who may have a need for it. If you have a situation where you send long text files from one of your offices to another by modem, then use this program to strip out all unnecessary Spaces, Page Offsets, and Extra Blank Lines before you send it via modem. Then use this same program at the receiving end to put the Page Offset back into the Text file again. It can be a real time saver (even if you use "Data Compression"). Program authors can produce smaller "DOC" files by using this routine, which will cut down on modem transmission time and file sizes. The Users can then use RTRIM to "adjust" the Text files for printing after they've downloaded the files and have read them on their monitors. It just seems like a big waste of time, effort, money and disk space to send, transmit and store thousands of empty spaces hiding inside most Text files. We suggest that you run RTRIM and use "this" file (RTRIM.DOC) for your "Input File" (...use the command RTRIM RTRIM.DOC/E/H/J/L). We have "Stacked The Deck" a little with "RTRIM.DOC", but it will help you to see what a BIG difference RTRIMMING a file can make. We would be most interested in hearing about any suggestions for improvements (or complaints) which you may have about RTRIM. Heck, we'd even be glad to just know that you are using it. Enjoy! Bob Keber SAMPLE OF WHAT A FILE LOOKS LIKE WITH "HIGH-BITS" SET ---------------------------------------------------------------------- This program is presented at "No Charge" to the PC User as a way of saying "Thanks" for all of the support and encouragement "we" have been given by our "Users & Distributors" during the past few years. There are many dedicated people and organizations between "us" and our Users, who have helped us to Sell and Distribute many of our programs. The Sysops, Librarians, User Groups, SIGs and "Shareware Catalog" people have done a good job for us, and we offer our thanks to you. ---------------------------------------------------------------------- <<<<<<<<<<**************************************************>>>>>>>>>> |||||||||| ADDITIONAL "KEBER" SOFTWARE PRODUCTS |||||||||| <<<<<<<<<<**************************************************>>>>>>>>>> ADDRESS CONTROLLER: Powerful yet Simple Address & Phone List Manager: Handles Multiple Address Files. Does Multiple Label Outputs. Prints 2 Phone Book Directories & 3 Address Book Directories. Prints Index & Rolodex Cards. Find records by ID# or SEARCH & FIND on ANY field. Address Records have fields for 2 Telephone Numbers & 2 Extension Numbers. Also has a 67 Character COMMENT field and an Address CATEGORY field. BROWSE through Address Lists with Arrow Keys. Pick/Choose "Who" to print Labels for. LOCK-IN repetitious field entries when entering records from "City Directories". Sends ANY "Printed Output" (even Labels) to the printer OR to a "Disk File". Maximum size of address files is 9,350 records, with an unlimited number of files. Can MERGE, EXTRACT & SORT address files. CONVERTS address files To/From RANDOM, SEQUENTIAL & DBASE formats. Version 9.2 - $42.00 "KEBER's NICE ADDRESS PROGRAM" ("K.N.A.P."): HEAVY DUTY ADDRESS & TELEPHONE program. Has most of the same features as Address Controller, but handles up to 725,000 Records per Address File. NO LIMIT on Files. Files never need Sorting, as new records are sorted as they are entered. Finds records by Partial NAME or ID#. Does International Addresses. Many Other Features. Super Fast & Feature Packed. Version 1.6 - $42.00 NOTE - Differences Between Address Controller & KNAP: Both programs are for business or personal use, and each has many of the same features. Address Controller uses standard Random Data files. These files need to be sorted periodically, as new records are always added to the end of the file (there is a menu selection for the sorting routine). Address Controller address files are limited to 9,300 records maximum per file. Commas & Quotes are not allowed, and are filtered out during data entry. File conversion to/from ASCII and DBASE III formats are supported. Keber's Nice Address Program (KNAP) uses a "Binary Indexed Tree" Random file system. It's records are automatically sorted by "Index Files" as new records are entered, and it's files never need sorting. KNAP Data files are limited to approximately 720,000 records per file. Commas & Quotes ARE allowed in any record. File conversion for Import/Export is NOT supported. "GENERAL INVOICE SALES TRACKER PLUS" ("GP" or "GIST-PLUS"): GIST-PLUS is a "Customer Billing" program. "GP" is NOT an accounting program, it is a "GROSS INCOME" program. It provides all of the "Income" information that most Accountants or Bookkeepers require from a small business. In most cases, they will only need some "GP" Printouts, and the Bank Statements and Check Stubs to maintain a firm's books. BRIEF LISTING OF PROGRAM's FEATURES Customers: - Shows "Last Sale Date" & "Total Amount Spent" for every customer. - Prints a Customer Telephone Directory (2 phones with extension #s). - Prints Two Customer Address Directories (Long & Short Versions). - Prints Customer Mailing Labels (by Name/City/State/Zip/Area/Etc.). - Large "Comment Field" for Special Terms, Ship/Bill To Address, Etc. - Prints a Customer Statement or Customer Invoice for any account. - Data fields are designed to allow INTERNATIONAL address entries. - Prints Labels/Phone/Address Lists by Sales Territory or entire office. Invoices: - Use "Hand Written" invoices or let "GP" Produce & Print your Invoices. - Allows Custom Listings of Descriptions, Part#'s and Work Performed. - Sales Tax can be configured to comply with most Laws & Regulations. - Can Print Multiple copies of Invoices (Customer & File Copies). - Generates Invoice & Customer Numbers Automatically (No Duplicates) - Prints Accounts Receivable Statements with matching Mailing Labels. - Prints a Ledger of Invoices for any "Time Period/Customer/Employee". - Prints a Ledger of invoices with totals for Accounts Receivable. - Provides 12 "ReNameable" Sales Categories plus ReNameable Sales Tax. - Provides 10 "ReNameable" Sets of "Terms & Conditions". - Handles "Partial" or "Installment" payments. - Packing List - List & Print up to 675 items per Packing List. - Each invoice may have more than one Packing List. - Inventory List - Pop-Up Scroll Bar Window with Sorted Inventory List. - Double checks "Calculations" on hand-written employee invoices. - Allows a Six Line "Heading" for your Name, Address & Telephone. - Allows a Six Line Invoice Footer for custom messages, disclaimers, etc.. - Extensive use of "Pop Up Windows" for easy use & simplicity. - Converts Invoice Values to hundreds of different currency values. - "Re-Bill" Feature Produces New Copies Of Previous Invoices. Income: - Prints/Displays Accounts Receivable Ledger & Customer Statements. - Prints Gross Income "Breakdown" by Sales Category for any time period. - Prints "Income Totals" from any Employee/Customer for any time period. - Prints ledger of "Accounts Paid" for any time period. - Shows Sales Tax Charged, Sales Tax Collected & Sales Tax UnCollected. - Displays or Prints Many Reports & Ledgers and shows averages. Inventory: - Support program: Provides ability to Create/Edit an Inventory Data File which holds up to 735 items. Automatic "% MarkUp" and "Retail Price" calculations. Entries appear in the "Invoice" and "Packing List" screens in a "Pop-Up" Scroll-Bar-Window for automatic data entry. Eliminates much of the work involved with constantly looking up prices for commonly sold items in printed supplier's price list catalogs. Packing Lists: - Support program: Provides ability to Create/Edit large "Packing Lists" (up to 675 items each) for inclusion with each customer's invoice. Multiple packing lists can be produced for each invoice. Program will create, edit, sort & print many different "Pre-Prepared" Packing Lists packing lists, or can produce custom (use once) lists. Accessed directly from the "GP" Invoice Menu. "Pop-Up" Scroll-Bar "Inventory" Window helps speed Packing List creation. General: - Maximum Invoice Total Amount = 11 Million - Maximum Invoice File Total Amount = 21.4 Million - Holds about 725,000 Customer Records & 725,000 Invoice Records. - Word Processing style commands for the majority of field entries. - Use "NAMES or NUMBERS" for retrieving records. - Find "Strong & Weak" categories of employee's performance. - Find "Strong & Weak" categories of Product & Service performance. - Unique "BROWSE" mode for viewing Customer & Invoice records. - Shows System "DATE & TIME" on "Main Menu". INTERNATIONAL FEATURES: - International Date Settings: MM/DD/YY DD/MM/YY or YY/MM/DD. - Time Settings: 12 or 24 Hour Clocks. - Changeable International Currency Symbols: Dollars, Pounds, Yen, Etc. - Two International Currency Formats: 1,234.56 or 1.234,56 Currency Conversion: - Support program: Program will provide "On Screen" currency conversions of an invoice's values, to any of several hundred different currencies. Select the Country to convert your invoice values to from a "Pop-Up" Scroll-Bar window. The top portion of the Invoice Screen will then show the converted values of the amounts displayed on the lower half of the Invoice Screen. Also offers a routine to "Print the Conversions". System Requirements: - Computer - PC/XT/AT/286/386/486 or Close Compatible - DOS or MS/DOS Version 3.3 or higher - Ram Memory - 640k (Use of ALL features requires about 400k of FREE Ram) - Hard Drive Recommended - Monitor - Mono or Color - 80 column - Printer - 80 Column Dot Matrix - IBM ProPrinter or Epson FX compatible. Version 3.78 - $89.00 SOFTWARE SALES TRACKER ("S.S.T."): A Sales Tracking program for Software Authors who distribute and sell their own software products. Handles multiple Product Files, changing files quickly through "Pop-Up Windows". Provides "Gross Income" information, displaying a wide variety of totals, sub totals and averages for an entire file, or for any range of dates you select. Issues Program Serial Numbers. File records store Customer Address & Phone, Serial #'s, Program Name & Version, Quantity, Price, Shipping, Sales Tax, Dates Sold & Paid, Purchase Orders & Check #'s (and has a 67 space COMMENT field). Printing routines include Mailing Labels, Customer Address & Phone Books, Invoices, Customer Statements (Acc/Rec), Index & Rolodex Cards, Shipping Labels, "Print To Disk Files", and much more. Software Sales Tracker - PATCH ("SSTPATCH"): A separate program (but part of.., and included with "SST") for easily "Patching" a Customer's Name, Date Of Sale, and Registered Product Serial Number into any of YOUR "EXE" programs. Includes an "Automatic Bulk Disk Preparation" feature. When on "Full Automatic" SSTPATCH will read data from your "SST" product files, patch your "EXE" files with your customer information, and then print a mailing label and a disk contents label. It then follows a list of commands which YOU provide for final disk preparation (FORMAT, REDATE, ARC-IT, COPY, etc.). This "automates" the task of sending out hundreds of disks to Customers and Distributors. The only thing you need to do is keep blank disks in the drives, stick on the labels, and mail the finished product. Both the "SST" & "SSTPATCH" programs are part of the same software package, and are shipped accordingly. Version 3.3 - $42.00 "POP-LABEL" ("PL"): A small, fast, "Pop-Up-Window" that will allow you to quickly type up and print a "Label" (or multiple copies of a Label) for most any purpose (contents labels, address labels, report cover labels, etc.). Each Label can hold up to five lines with 32 to 70 characters per line. Printed output is straight ASCII Text, and should work with most parallel printers. Other features: Print Multiple Copies, Set Left Margin, Re-Edit a Label, Automatic or Manual printer Print Settings. Another option will Save/Read frequently used labels to disk files. Version 2.0 - $18.00 TAKE ONE OF THE PROGRAMS ABOVE FOR A TEST DRIVE? If you would like to "Try" one or more of the above programs, and are unable to obtain them from your normal software supplier, we will be glad to send "UnRegistered Evaluation" versions directly to you for a small fee to cover Shipping & Handling expenses. ANY 1 PROGRAM = $8.00 (Specify Disk Size & Capacity) Send us a note stating which program(s) you would like to try. Please specify the programs by NAME (not just "Send All Programs"). As time goes by, new programs will be added to this list. That's why we will need Program Names to properly fill your order. Be sure to include your Name, Return Address, Telephone and Check. Orders are are usually shipped within 24 hours of receipt. Make Checks Payable To: "R. KEBER" ROBERT F. KEBER JR. 336 Swain Blvd. Greenacres, Florida 33463-3342 (407) 969-3643 If you wish to purchase a "REGISTERED" version of any of the above programs, send a check for the amount shown at the bottom corner of each program's description. There is NO Shipping & Handling Charge on any Registered Version (USA Only). International orders, add $5.00 (USD) for Shipping & Handling. Florida residents, please ADD Sales Tax. After December 1993, we suggest that you call us for an updated price BEFORE you send in your order. All prices and features are subject to periodic changes without notice.